home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / program / inter54f.zip / INT2WHLP.ZIP / I2W-CFG.TXT < prev    next >
Text File  |  1995-12-29  |  16KB  |  361 lines
  1. ; The INT2WHLP configuration file has sections and entries similar to
  2. ; Windows INI files.
  3. ; Sections have identifiers enclosed in brackets [], starting at the left
  4. ; margin. A section extends up to the next line starting with a left
  5. ; bracket [ at the left margin.
  6. ; Entries have identifiers starting at the left margin and extending up
  7. ; to an equal sign =. The value of an entry is the string or integer after
  8. ; the equal sign. INT2WHLP interprets digit 0 as boolean value false and
  9. ; any non-zero integer as boolean true when interpreted with the
  10. ; profileBoolean() procedure.
  11. ; Section and entry identifiers are not case sensitive, however spaces
  12. ; are significant caracters in identifiers. There may not be excessive
  13. ; spaces around the equal sign in entries (i.e. only spaces which are part
  14. ; of the identifier or value).
  15. ; A semicolon ; at the left margin identifies a comment.
  16.  
  17. ; In the following text enabled identifiers specify default program
  18. ; settings (unless otherwise noted), and commented-out identifiers are
  19. ; examples of valid values.
  20.  
  21. ; The FILES section specifies the pathes for the input and output files.
  22. ; These values can also be specified as program parameters, program
  23. ; parameters take precedence over values defined in the configuration
  24. ; file. The program will request values if neither program parameters,
  25. ; nor the configuration file, define values.
  26. [FILES]
  27. inPath=
  28. ; inPath=c:\interrup
  29. ; The input files are in directory C:\INTERRUP.
  30. outPath=
  31. ; outPath=.
  32. ; Pass the output files to the current directory.
  33.  
  34. ; The OPTIONS section specifies values which can also be set by program
  35. ; parameter options. Program paramter options take precedence over values
  36. ; specified in the configuration file.
  37. [OPTIONS]
  38. build=
  39. ; build=(WINENV | APP1) & TESTBUILD
  40. ; Copies the build expression to the HPJ file's [OPTIONS] section build=
  41. ; entry. See also the [BUILDTAGS] section. Program option -b. Note that
  42. ; the OR operator "|" cannot be passed as a program option, only the
  43. ; configuration file can pass the OR operator to the program.
  44. compression=none
  45. ; compression=medium
  46. ; compression=high
  47. ; Sets HC31 compression option. Program option -c.
  48. filterFile=
  49. ; filterFile=INTWIN.FLT
  50. ; Should be empty for a compilation of the entier Interrupt List, or define
  51. ; a filter file for a partial compilation. Program option -f.
  52. ; NOTE! It is recommended not to perform a partial compilation because
  53. ; references to tables may be missing.
  54. singlesInMain=0
  55. ; singlesInMain=1
  56. ; If 1, interrupt numbers with only one entry are inserted directly in the
  57. ; compressed index rather than a reference to a one-entry subindex, provided
  58. ; that the number of compressed index columns is set to 1. singlesInMain=1
  59. ; may be an advantage for a strongly filtered list. Program option -1.
  60. twoIndexes=1
  61. ; twoIndexes=0
  62. ; Enables or disables the expanded index. Program option -2.
  63. errorLog=0
  64. ; errorLog=1
  65. ; Disables or enables HC31's log file OutPath\INTWIN.ERR. Program option -e.
  66. headers=1
  67. ; headers=0
  68. ; If 1, insert a header for each new interrupt number in the expanded index.
  69. ; Program option -h.
  70. indexColumns=1
  71. ; indexColumns=4
  72. ; indexColumns=8
  73. ; indexColumns=16
  74. ; Specifies the number of columns in the compressed index. Program option -i.
  75. markKeys=1
  76. ; markKeys=0
  77. ; Controls whether or not keywords (like "See also:", "Notes:") are marked
  78. ; (bolded). The program compiles the List 20% faster, and HC31 yields a 1%
  79. ; shorter .HLP file when disabled, but the readability of the result is lower.
  80. ; Program option -m.
  81. longKeys=1
  82. ; longKeys=0
  83. ; Specifies whether both long and sort versions of interrupt search keys are
  84. ; used, or short versions only.
  85. ; Program option -l.
  86. equalBlanks=1
  87. ; equalBlanks=0
  88. ; Specifies whether or not spaces are inserted around the equal sign in
  89. ; register search strings, e.g. "INT 21 AH = 4C" or "INT 21 AH=4C". Program
  90. ; option -q.
  91. releaseNo=41
  92. ; releaseNo=40
  93. ; Controls Interrupt List release number dependent behavior of INT2WHLP.
  94. ; Implemented influence:
  95. ;   releaseNo<41:  Tables are not treated as separate topics, no table cross
  96. ;           references.
  97. ; Program option -r
  98. scrollIndexTitle=1
  99. ; scrollIndexTitle=0
  100. ; Index windows have a general header and a title. If scrollIndexTitle=1,
  101. ; the title scrolls with the rest of the index window, otherwise the title
  102. ; is part of the non-scrolling header region. Program option -s.
  103. tableWindow=1
  104. ; tableWindow=0
  105. ; If 1, tables referenced from text (with a #nnnn hotspot) appear in
  106. ; a secodary window. The table can be copied to the main window with a
  107. ; "Copy to main" hotspot included in all tables.
  108. ; If 0, tables appear in the main window.
  109. ; Program option -t
  110. expandedIndex=1
  111. ; expandedIndex=0
  112. ; 1 or 0 causes the Interrupt List Index initially to pop up in expanded (all
  113. ; entries in one window) or in compressed (index with subindexes) format.
  114. ; Program option -x
  115.  
  116.  
  117. ; The CONFIG section defines WINHELP setups and defaults.
  118. [CONFIG]
  119. pos and size=
  120. ; pos and size=(0,0,980,1023)
  121. ; Defines the position and size of the initial main window. The format is
  122. ; (xpos,ypos,width,height) and valid values are 0..1023, defining 1024th
  123. ; of the screen witdh and hight. xpos+width and ypos+hight may not exceed
  124. ; 1023.
  125. secondary pos and size=(43,0,980,1023)
  126. ; secondary pos and size=(243,0,780,850)
  127. ; Defines the position and size of the secondary window. The format is the
  128. ; same as for "pos and size". The initial size of a secondary window MUST
  129. ; be defined. Users of large, high resolution screens may prefer the choice
  130. ; that is disabled above.
  131. ; The entry is ignored if secondary table windows are disabled.
  132. background=
  133. ; background=(255,255,255)
  134. ; Defines the background color of the normal text window in the format
  135. ; (red,green,blue). Valid values are 0..255. (255,255,255) defines a
  136. ; white background color.
  137. header background=
  138. ; header background=(255,255,192)
  139. ; Defines the background color of the non-scrolling part of the windows.
  140. ; (255,255,192) defines a light yellow color.
  141. text font=modern Courier New
  142. ; Defines the font used for the plain text. Due to the tables in the
  143. ; Interrupt List, this should be a fixed pitch font, and because it should
  144. ; be a TrueType font to take advantage of the font sizing, Windows 3.1
  145. ; has no alternatives. "modern" is the font family (modern=fixed pitch,
  146. ; roman=proportionally spaced serif, swiss=proportionally spaced sans serif),
  147. ; and "Courier New" is the font name.
  148. ; If point size 10 or 12 (see deciPoints) is used, the bitmapped font
  149. ; "modern Courier" can be used, though.
  150. header font=roman Times New Roman
  151. ; header font=swiss Arial
  152. ; Font used for headers.
  153. deciPoints=90
  154. ; deciPoints=95
  155. ; deciPoints=100
  156. ; deciPoints=120
  157. ; 10 times the font point size. A 9 point font can be displayed on a
  158. ; standard VGA screen without the need of horizontal scroll. The point
  159. ; size is not true typographical point size, it varies with screen
  160. ; resolution and size, and a larger point size is preferable for a high
  161. ; resolution screen with small dimensions. HC31 assigns size in half-points,
  162. ; corresponding to deciPoints increments of 5.
  163. header deciPoints=140
  164. header 2nd deciPoints=120
  165. ; Two font sizes used in the headers.
  166.  
  167. ; The INTWINCONFIG section is optional and is not used for program generated
  168. ; output. Entries in the section are copied to the help project file's
  169. ; [CONFIG] section. It can be used to insert macros in the final help file.
  170. ;[INTWINCONFIG]
  171. ;InsertItem("mnu_help","mnu_h","&INTWIN Help","JI(`',`idHelp')",0)
  172.  
  173. ; The WINDOWS section defines the number of extra "windows" included in
  174. ; the compilation in addition to the Interrupt List.
  175. [WINDOWS]
  176. number=4
  177. ; Number of additional windows (5 are defined, but only 4 enabled).
  178. ; NB! number=0 is the program default, and the following windows are not
  179. ; defined by default.
  180.  
  181. ; For each window defined by the [WINDOWS] number=n entry, there must be
  182. ; a section [WINDOW 1], ... [WINDOW 9], [WINDOW 10], ... [WINDOW n] with
  183. ; 3 obligatory entries and some optional entries.
  184. [WINDOW 1]
  185. title=Ports
  186. id=idPorts
  187. ; title and id are obligatory entries defining the topic title and
  188. ; identifier (context string). [WINDOW i] sections with an empty title=
  189. ; or id= entry are ignored, and a warning is printed on the screen.
  190. ; See comment "Help windows topic titles and identifiers" in INT2WHLP.INC
  191. ; for reserved identifiers.
  192. type=2
  193. ; There are 3 window types: type=1 are single entry windows referenced
  194. ; directly from the main index. type=1 is the default type. type=2 are
  195. ; windows with their own index, which is referenced from the main index.
  196. ; The differences between type=1 and type=2 are the browse chain linkage
  197. ; and the default "file n type=" value. type=3 defines a window with at
  198. ; least one RTF file defining the window properties. The RTF file must
  199. ; have a topic with the identifier (context string) defined by id=, and
  200. ; that topic should have a title defined by title= and contain an index
  201. ; for the system.
  202. ; files=1
  203. ; The entry files= defines the number of files included in the current
  204. ; window. Only type=3 windows can have more than one file, and files=1 is
  205. ; the default value.
  206. file 1=ports.lst
  207. ; For each file i = 1..n defined by the files=n entry (normally only 1)
  208. ; there must be a file i=<file name> entry specifying a file. See a later
  209. ; paragraph about default directories.
  210. ;
  211. ; file 1 type=2
  212. ; There are 4 file types: file i type=1 are files passed to the program's
  213. ; ProcessFile() procedure. file i type=2 are files passed to the program's
  214. ; ProcessPort() procedure. file i type=3 are RTF files defining their own
  215. ; and other included files' properties. file i type=4 are files assigned
  216. ; their own titles and identifiers (context strings). type=4 files are
  217. ; passed to the program's ProcessFile() procedure, and they should be
  218. ; referenced from an RTF file.
  219. ; The default file i type= value is the window's type= value.
  220. ; Files' default directories depend on the file types. File types 1 and 2
  221. ; are typically files included in the Interrupt List: PORTS.LST, MEMORY.LST
  222. ; etc. Therefore, the default directory for file types 1 and 2 is the
  223. ; InPath directory. File type 3 are typically the user's own file or one
  224. ; of the RTF files supplied in this package, so the default directory
  225. ; is 1) the current directory or 2) INT2WHLP's home directory. File type
  226. ; 4 are the users own files, and the default directory is the current
  227. ; directory.
  228. ; In all cases the full path (a path including a drive, the root, or the
  229. ; current or parent directory . or ..) can be specified to override the
  230. ; default directory.
  231. ;
  232. ; file i title=<title>
  233. ; file i id=<id>
  234. ; file i chain=<browse chain>
  235. ; Type 4 files have titles, identifiers, and browse chain definitions.
  236. ; The default values are "<window title> - i", "<window id>_i", and
  237. ; "<window id>:5" where i is the current file number. The empty value is
  238. ; legal for file i chain= and causes the file to be excluded from any
  239. ; browse chain.
  240. ; See comment "Help windows topic titles and identifiers" in INT2WHLP.INC
  241. ; for implemented browse chains.
  242.  
  243. [WINDOW 2]
  244. title=Memory
  245. id=idMemory
  246. ; type=1 is the default window type
  247. ; files=1 is the default number of files
  248. file 1=memory.lst
  249. ; file 1 type=1 is the default type because the window type is 1.
  250.  
  251. [WINDOW 3]
  252. title=CPU
  253. id=idCPU
  254. file 1=86bugs.lst
  255.  
  256. [WINDOW 4]
  257. title=CMOS
  258. id=idCMOS
  259. file 1=cmos.lst
  260.  
  261. ;[WINDOW 5]
  262. ;   (This part is disabled due to aliases required by the assosiated file)
  263. ;title=Miscellaneous Information
  264. ;id=MISC_INF_0
  265. ;type=3
  266. ; type=3 specifies a window with its own definition in an RTF file.
  267. ; MISC_INF_0 is the identifier (context string) for one of the topics in
  268. ; the RTF file. That topic is normally an index for other topics in the
  269. ; file.
  270. ;
  271. ; files=1 is the default number of files
  272. ;file 1=misc_inf.rtf
  273. ;   (misc_inf.rtf references context strings that should be defined in the
  274. ;    ALIAS part of the configuration file)
  275. ; file 1 type=3 is the default type because the window type is 3. It
  276. ; specifies an RTF file.
  277.  
  278. ; The ALIAS section is optional and is not used for program generated
  279. ; output. It compiles an ALIAS list to the HPJ file. Two of the RTF files
  280. ; supplied in this pasckage (SEL_TOPC.RTF and MISC_INF.RTF) require
  281. ; some aliases.
  282. ; [ALIAS]
  283. ; id87err=INT 10 ---- - CPU-generated (80286+) - COPROCESSOR ERROR
  284. ; idVideo_00=INT 10 00-- - VIDEO - SET VIDEO MODE
  285. ; idVideo_1013=INT 10 1013 - VIDEO - SELECT VIDEO DAC COLOR PAGE (VGA)
  286. ; Each entry is of the form
  287. ;   id=<modified INT header>
  288. ; where id is a user defined identifier (context string) no longer than 18
  289. ; characters, and <modified INT header> is an INT header with flags removed
  290. ; from char. pos. 9+ (i.e. if char. 9 is not "-" then delete up to, but not
  291. ; including, a "-" character), and with a register value (from the divider
  292. ; line char. pos. 13-16) + a space inserted at char. pos. 8-12, as shown in
  293. ; the example. The program substitutes the actual identifier (context string)
  294. ; for the <modified INT header> and copies the id=actual_id part to an
  295. ; [ALIAS] section in the HPJ file. The example would result in an HPJ
  296. ; section (based on Interrupt List release 40):
  297. ;
  298. ; [ALIAS]
  299. ; id87err=10_1
  300. ; idVideo_00=10_2
  301. ; idVideo_1013=10_46
  302. ;
  303. ; The entries must appear in the same order as the <modified INT header>
  304. ; appear in the Interrupt List. The program can assign more than one user
  305. ; defined id to the same interrupt entry in the list, the entries must of
  306. ; course be consecutive and have identical <modified INT header> values.
  307. ;
  308. ; Empty lines and lines starting with a semicolon (;) are ignored.
  309.  
  310. ; Also the TABLEALIAS section is optional and compiles an ALIAS list to the
  311. ; HPJ file. SEL_TOPC.RTF require some tabel aliases.
  312. ; [TABLEALIAS]
  313. ; idListList=21 52-- Format of List of Lists:
  314. ; Each entry is of the form
  315. ;   id=II FUNC <title>
  316. ; where id is a user defined identifier (context string) no longer than 18
  317. ; characters, II is a two digit hexadecimal number and FUNC is four characters
  318. ; describing the subfunction where the table is located. II and FUNC are also
  319. ; characters 11-12 and 13-16 of the previous divider line. <title> is the
  320. ; table's title. The program substitutes the actual identifier (context
  321. ; string) for the II FUNC <title> part and copies the id=actual_id part to
  322. ; an [ALIAS] section in the HPJ file, mixed with the output from an [AIAS]
  323. ; section in the configuration file. The example would insert in an HPJ
  324. ; [ALIAS] section an entry like (depending on Interrupt List release):
  325. ;
  326. ; idListList=t0724
  327. ;
  328. ; The entries must appear in the same order as the tables appear in the
  329. ; Interrupt List. The program can assign more than one user defined id to
  330. ; the same table.
  331. ;
  332. ; Empty lines and lines starting with a semicolon (;) are ignored.
  333.  
  334. ; The INTWINCONFIG section is optional and is not used for program generated
  335. ; output. It is included to facilitate copying macros to the [CONFIG]
  336. ; section in the Help Project File.
  337. ; [INTWINCONFIG]
  338. ; InsertItem("mnu_help","mnu_hlp","&INTWIN Help","JI(`',`idHelp')",0)
  339.  
  340. ; The BUILDTAGS section is optional and is not used for program generated
  341. ; output. It is included to support users' RTF files with conditional
  342. ; build. If the user's RTF files have build tags ("*" footnotes), the tags
  343. ; must be defined in a BUILDTAGS section in the configuration file.
  344. ; [BUILDTAGS]
  345. ; WINENV
  346. ; APP1
  347. ; TESTBUILD
  348. ;
  349. ; The BUILGTAGS section is simply copied to the HPJ file, ignoring empty
  350. ; lines and lines starting with a semicolon (;).
  351. ;
  352. ; See also the [OPTIONS] section's build= entry.
  353.  
  354. ; The BAGGAGE section is optional and is not used for program generated
  355. ; output. It is included to support inclusion of baggage in the help file.
  356. ; [BAGGAGE]
  357. ; BAG.INI
  358. ;
  359. ; The BAGGAGE section is simply copied to the HPJ file, ignoring empty
  360. ; lines and lines starting with a semicolon (;).
  361.